Return

Edit Task: SetPossibility Timeslot

Description

The SetPossibility Timeslot attribute under EditTask defines the start and stop times for a task assignment possibility.

Parameters

ParameterDescription
PossibilityNameA string of text with a comma delimited list of resources in the possibility, surrounded by single quotes. Order is not required and the resource names should not be in quotes.
StartRepresents the start time for a possibility report time. This time should be space delimited and in the same format as the times used in the Time Import Files. The format is YYYY/MM/DD_HH:MM:SS or YYYY/MM/DD_HH:MM:SS.fff.
StopRepresents the stop time for a possibility report time. This time should be space delimited and in the same format as the times used in the Time Import Files. The format is YYYY/MM/DD_HH:MM:SS or YYYY/MM/DD_HH:MM:SS.fff.
PreferredStartTimeFormat is YYYY/MM/DD_HH:MM:SS or YYYY/MM/DD_HH:MM:SS.fff. This parameter is optional and is used to set a preferred start time within the existing window and must be between TimeslotStartTime and TimeslotStopTime minus the minimum duration of the task. If TimeslotPreferredStartTime is omitted then TimeslotPreferredStartTime is defaulted to TimeslotStartTime.
DesirabilityAn integer or decimal value between 0 and 100.
CommentA string of text in single quotes of the desired comment for the possibility timeslot. Empty string is allowed.

Examples

Change the timeslot times for a given possibility.

PATCH api/task/TaskA

Body:

{

"SetPossibility" : {

"PossibilityName" : "ResA",

"Timeslot" : {

"Start" : "2015/01/01_07:17:21",

"Stop" : "2015/01/01_07:42:36" ,

"PreferredStartTime" : "2015/01/01_07:20:00:57",

"Comment" : "Edited timeslot" }

}

}